home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / poe113pl.arc / POE.DOC < prev    next >
Text File  |  1990-01-29  |  11KB  |  259 lines
  1.                           ProComm Outside Environment
  2.                                    POE 1.1.0
  3.                                August 18th, 1987
  4.  
  5.                       Copyright (c) 1987 by Mark Herring
  6.                          Donated to the Public Domain
  7.  
  8.  
  9.  
  10.          Before we get started...
  11.   
  12.                 I, Mark  Herring,  have  donated  POE  to  the  Public
  13.                 Domain.   This  means that you may make as many copies
  14.                 of POE as you wish, and that you may give POE to  your
  15.                 friends.
  16.  
  17.                 I  COULD  have  made POE a shareware product, but many
  18.                 factors contributed  to  my  decision  to  donate  the
  19.                 system to the Public Domain:
  20.  
  21.                         If I requested  a  registration  fee,  then  I 
  22.                         would  HAVE  to  support  my registered users. 
  23.                         Since it cost you nothing to  acquire  POE,  I 
  24.                         feel no obligation to SUPPORT it.  If you have 
  25.                         problems   with   the   system,   you'll  find 
  26.                         telephone numbers at  the  end  of  this  file 
  27.                         telling  you how to leave messages for me.  If 
  28.                         you  send  me  a  message  via  one  of  these 
  29.                         systems, I'll send you back a reply. 
  30.  
  31.                         I have seen many programs that  were  released
  32.                         as  shareware that wouldn't be worth the phone
  33.                         bill it took to download them.   Some  systems
  34.                         have been obviously written in only hours, and
  35.                         people  expect others to send them money for a
  36.                         "shoddy" job.  If a  package  is  released  as
  37.                         Shareware,   the  authors  should  take  their
  38.                         system as seriously as  if  it  were  sold  by
  39.                         Microsoft!   There  are many systems out there
  40.                         that  qualify  for   Shareware   (ProComm   is
  41.                         certainly one), while there are many more that
  42.                         give the name a black eye.
  43.  
  44.                         Finally, if I don't accept money, I also don't
  45.                         accept any responsibility  for  what  POE  may
  46.                         ever  do  to  your  system.  It's been checked
  47.                         for problems, and up until now, none have been
  48.                         found.  However, if POE chokes on  your  cache
  49.                         and destroys your FAT table, don't come crying
  50.                         to me!  Caveat Empetor!
  51.  
  52.  
  53.  
  54.                 What is POE?
  55.  
  56.                 POE is a utility that will let you add  external  file
  57.                 protocols  to  ProComm or any other telecommunications
  58.                 system.    POE  will  also  allow  you to run up to 15
  59.                 different programs from inside ProComm.   POE.EXE  and
  60.                 POE.CFG  should reside in your ProComm subdirectory.
  61.  
  62.                 Let's    face...everyone    has   their  own  favorite 
  63.                 communications  system.  I  believe that ProComm beats 
  64.                 all of the others hands down,  except when it came  to 
  65.                 the   newer   "external"   protocols  that  are  being 
  66.                 developed.  Since I refuse  to  change  to  one  other 
  67.                 "inferior"  communication  programs  out there just to 
  68.                 pickup a new protocol,  I wrote POE so I could  easily 
  69.                 call them up with a ProComm-styled interface.  I could 
  70.                 just   as  easily  dropped  to  DOS  and  execute  the 
  71.                 protocols,  but I'm a consultant  by  trade,  and  all 
  72.                 programmers are lazy to begin with!  Hence,  I created 
  73.                 POE.  Now, ProComm has it all! 
  74.  
  75.                 POE  is  designed  to  "hook" into ProComm through the
  76.                 ALT-A command.  Datastorm  Technologies  designed  the
  77.                 ALT-A  command to interface with your favorite editor.
  78.                 We use this key to call up POE instead.
  79.  
  80.                 Before you can call  up  POE  using  ALT-A,  you  must
  81.                 reconfigure  ProComm to execute POE.  Here's how to do
  82.                 this:
  83.  
  84.                 1. Execute ProComm.
  85.                 2. Press the ALT-S key combination.
  86.                 3. Select option #4 from the menu...GENERAL SETUP.
  87.                 4. Select option #1 from the GENERAL SETUP menu.
  88.                 5. Type POE and press Return.
  89.                 6. Press the [ESC] key.
  90.                 7. Press the [S] key.
  91.                 8. Press the [ESC] key.
  92.  
  93.                 There!  If POE is sitting in  your  ProComm  directory
  94.                 (and  assuming  that you are too), then pressing ALT-A
  95.                 will call up POE!
  96.  
  97.  
  98.  
  99.                 Configuring POE.
  100.  
  101.                 POE.EXE  is  distributed  with  POE.CFG  and  DSZ.EXE.
  102.                 POE.CFG is a configuration file that  tells  POE  what
  103.                 transfer  protocols  are available.
  104.          
  105.                 POE will look for the POE.CFG  file  in  your  current 
  106.                 subdirectory.  If  you  have  used the DOS SET command 
  107.                 (as  described  in  your  ProComm   manual)   to   SET 
  108.                 PROCOMM=[subdirectory],  then  POE  will  look  inside 
  109.                 [subdirectory] for it instead. 
  110.                          
  111.                 POE understands a few commands that reside inside  the 
  112.                 POE.CFG file: 
  113.  
  114.  
  115.                 COLOR
  116.  
  117.                         The COLOR command allows  you  to  change  the
  118.                         colors that POE displays on the screen.
  119.  
  120.                         Format: COLOR {old color no}={new color no}
  121.  
  122.                         Color numbers   Description
  123.                         -------------   -----------
  124.                               0         Black
  125.                               1         Blue
  126.                               2         Green
  127.                               3         Cyan
  128.                               4         Red
  129.                               5         Magenta
  130.                               6         Yellow
  131.                               7         White
  132.  
  133.  
  134.                 UP PATH=path name
  135.  
  136.                         This command will set the upload path.
  137.                         Example: UP PATH=C:\TERM\UP
  138.  
  139.                 DL PATH=path name
  140.  
  141.                         This command will set the download path.
  142.                         Example: DL PATH=C:\TERM\DL
  143.  
  144.                 MS PATH=path name
  145.  
  146.                         This command will set the path for your
  147.                         miscellaneous programs.
  148.                         Example: MS PATH=C:\PROGRAMS
  149.  
  150.  
  151.                 UP PROTOCOL=protocol description,command[,path name]
  152.  
  153.                         UP  PROTOCOL  describes  an upload protocol to
  154.                         POE.  Example:
  155.  
  156.                         UP PROTOCOL=Zmodem upload,DSZ sz !
  157.  
  158.                         The ! at the end of the command tells  POE  to
  159.                         ask   for   additional  parameters  when  this
  160.                         protocol is selected.
  161.  
  162.                         You may  also  append  a  path  name  that  is
  163.                         special  to  this one protocol.  If you do use
  164.                         a path name, it overrides any path  name  that
  165.                         was setup with UP PATH=.
  166.  
  167.  
  168.                 DL PROTOCOL=protocol description,command[,path name]
  169.  
  170.                         DL  PROTOCOL  describes a download protocol to
  171.                         POE.  Example:
  172.  
  173.                         DL PROTOCOL=Zmodem download,DSZ rz !
  174.  
  175.                         The ! at the end of the command tells  POE  to
  176.                         ask   for   additional  parameters  when  this
  177.                         protocol is selected.
  178.  
  179.                         You may  also  append  a  path  name  that  is
  180.                         special  to  this one protocol.  If you do use
  181.                         a path name, it overrides any path  name  that
  182.                         was setup with UP PATH=.
  183.  
  184.  
  185.                 MISC=Program description,command,[path name]
  186.  
  187.                         POE can also run external programs outside  of
  188.                         ProComm.   The  MISC=  command describes these
  189.                         programs.  For example:
  190.  
  191.                         MISC=Directory management,DR,C:\
  192.  
  193.                         Notice that this command also  uses  the  path
  194.                         name option. The C:\ tells POE that the program
  195.                         DR may be found in the root directory.
  196.  
  197.          
  198.                 PAUSE
  199.          
  200.                         PAUSE will cause POE to pause before returning
  201.                         to ProComm.
  202.          
  203.          
  204.                 ALARM
  205.          
  206.                         ALARM will sound an alarm before returning to
  207.                         ProComm.
  208.  
  209.  
  210.  
  211.  
  212.                 Getting to me.
  213.  
  214.                 If you find you are having problems with POE,  you may 
  215.                 leave messages for me on the PC-Board Echo  Conference 
  216.                 Systems.  We're  a  system  of  PC  Boards  that  pass 
  217.                 echomail nightly.  Feel free to call these fine boards 
  218.                 listed below and check it out! 
  219.  
  220.  
  221.                 Most of these systems can be reached via PC-Pursuit:
  222.  
  223.                 Unusual Situations, Memphis, TN     901-365-0407
  224.                 Sleepy Hollow, Los Angeles, CA      213-859-9334 *
  225.                 The Tool Shop, Phoenix, AZ          602-279-2673 *
  226.                 Redundant PCB, Salt Lake City, UT   801-487-5339 *
  227.                 Sparta PCB, Sparta, NJ              201-729-7056 *
  228.                 Ed Hopper's PCB, Houston, TX        713-782-5454 *
  229.  
  230.                 * PC-Pursuitable
  231.  
  232.  
  233.  
  234.  
  235.                 If  you  ever  need  consulting  for  ProComm,   we're 
  236.                 available! Reasonable rates quoted upon request. 
  237.  
  238.  
  239.  
  240.                 ProComm Forever!
  241.  
  242.                 Mark Herring
  243.                 1400 Phillips Road
  244.                 Memphis, TN   38134
  245.  
  246.  
  247.          
  248.          
  249.                 Release notes:
  250.          
  251.                 Version    Date       Description
  252.                 -------  --------     ----------------------------------
  253.                 1.0.0    07-22-87     Initial release.
  254.          
  255.                 1.0.1    08-18-87     SET PROCOMM= will locate POE.CFG         
  256.                                       PAUSE command added.
  257.                                       ALARM command added.
  258.                                          (Thanks Jeff Sumberg!)
  259.